Skip to content

GH-50697: [C++][FlightRPC] ODBC installer support fixes - #50748

Open
alinaliBQ wants to merge 2 commits into
apache:mainfrom
Bit-Quill:gh-50697-odbc-installer-fix
Open

GH-50697: [C++][FlightRPC] ODBC installer support fixes#50748
alinaliBQ wants to merge 2 commits into
apache:mainfrom
Bit-Quill:gh-50697-odbc-installer-fix

Conversation

@alinaliBQ

@alinaliBQ alinaliBQ commented Jul 30, 2026

Copy link
Copy Markdown
Collaborator

Rationale for this change

GH-50697

I have tested the RPM ODBC installer on AlmaLinux 9. The ODBC driver works as expected on AlmaLinux 9. The only issue I found was that the connection-options.md guide was not included in the package installation. This PR adds connection-options.md to the RPM ODBC package so users can reference the connection options documentation after installation.

Summary of testing results:

  1. Clean install - driver works as expected and registered successfully, arrow installer installs isql and unixODBC during installation.
  2. Uninstall - driver is uninstalled and unregistered automatically, arrow installer flags and uninstalls isql and unixODBC as unused dependency during installation.
    If user wants to avoid this behavior, they can add --noautoremove flag to make dnf keep isql and unixODBC during ODBC uninstallation.
  3. Upgrade - driver can be upgraded to new version.
  4. Data retrieval works as expected, no dependency issues found.

What changes are included in this PR?

  • Add connection-options.md to the RPM ODBC package installation.
    • Example location after install: /usr/share/doc/arrow2600-flight-sql-odbc-libs/connection-options.md
  • Fix Windows ODBC installer to include docs LICENSE.txt and NOTICE.txt
  • Add ODBC installer description to ODBC README.md

Are these changes tested?

Yes

Are there any user-facing changes?

Yes

- Add installer description to ReadMe
- Fix `docs` on Windows to include docs

Co-authored-by: justing-bq <justin.gossett@improving.com>
The installed file would be under `usr/share/doc/arrow2600-flight-sql-odbc-libs/connection-options.md`
@alinaliBQ alinaliBQ added CI: Extra: C++ Run extra C++ CI CI: Extra: Package: Linux Run extra Linux Packages CI labels Jul 30, 2026
@alinaliBQ
alinaliBQ marked this pull request as ready for review July 31, 2026 17:27
@alinaliBQ

Copy link
Copy Markdown
Collaborator Author

Hi @kou cc @lidavidm, this PR is ready for review.

The CI failures don't appear related to the code changes. Package Linux debian-trixie-arm64 failed due to operation being canceled. If possible, could you help to re-run debian-trixie-arm64?

@kou kou left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1

%files flight-sql-odbc-devel
%defattr(-,root,root,-)
%doc README.md
%doc cpp/src/arrow/flight/sql/odbc/connection-options.md

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-devel package doesn't need this because -libs includes this.

Suggested change
%doc cpp/src/arrow/flight/sql/odbc/connection-options.md

BTW, how about writing documentation in https://github.com/apache/arrow/tree/main/docs/source/cpp not cpp/src/arrow/flight/sql/odbc/*.md?

@github-actions github-actions Bot added awaiting merge Awaiting merge and removed awaiting review Awaiting review labels Aug 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants